═══ 1. HTMLGen - An Overview ═══ HTMLGen is a HTML script generator for OS/2. HTML scripts are used to generate Home Pages for World Wide Web browsers. HTMLGen provides a simple method for generating scripts. By selecting the appropriate tag, a dialog box will pop-up to gather data and fill in the script. ═══ 2. Adding To Desktop ═══ To place the program on your WPS Desktop use the following rexx script. /* Place HTMLGen on Your Desktop */ rc = RxFuncAdd("SysLoadFuncs","RexxUtil","SysLoadFuncs") rc = SysLoadFuncs() rc = SysCreateObject("WPProgram","HTMLGen","","exename="||directory()||"\htmlgen.exe") rc = SysSetIcon(directory()||"\htmlgen.exe","htmlgen.ico") ═══ 3. Register ═══ REGISTRATION FORM FOR HTMLGen Version 1.10 Registration fee is $45.00 per copy. North Carolina residents must include sales tax. In USA and Canada add $5.00 for shipping/handling. All other international shipments add $15.00. See other documentation. Send to: HTMLGen 1.10 American Coders, LTD P.O. Box 97462 Raleigh, NC 27624 Name:______________________________________ Phone: ____________ Company: ___________________________________ Phone: ____________ Address: ___________________________________________________________ ___________________________________________________________ City: _________________________ State: ______ Zip: _____________ CompuServe ID: _____________________________________________________ Where did you find HTMLGen: _______________________________________ Registered users get a 30 day money back guarantee, 60 days free telephone support, unlimited support on CompuServe, and free upgrades to the next release. CompuServe ID: 74150,2370 CompuServe Support: GO OS2SHARE Internet: joe@usacoder.rtp.nc.us Phone: (919) 846-2014. ═══ 4. Cut and Paste ═══ OS/2 Cut and Paste fucntions to the OS/2 clip-board are availablle. Cut Press CTRL-Delete. To place mark text into the clipboard and remove it from the script area. Copy Press CTRL-Insert. To copy the marked area to the clip-board. Paste Press Shift-Insert to copy clip-board text at the cursors position. Marking Text To Cut and Copy Press Shift and use the arrow keys to mark pieces of text in the script area. ═══ 5. Primary Window Menu ═══ There are several window menus to simplify your job. ═══ 5.1. File ═══ The file pull down provides access to OS/2 file system. ═══ 5.1.1. Open ═══ Open will load the script area with an existing. Any text in the script area will be lost. ═══ 5.1.2. New ═══ This will restart a script by removing existing text. ═══ 5.1.3. Save ═══ This will save the script area to a file. If a filename has not been defined the File dialog will pop-up. ═══ 5.1.4. Save As ═══ This will save the script area to a file. The File dialog will pop-up. ═══ 5.1.5. Insert Text ═══ This will insert text from another file into the script area. Text in the existing area will not be lost. ═══ 5.1.6. Browser ═══ This will load the current text area to the defined file and call the Web Browser you have defined on your system. ═══ 5.1.7. IPF Build ═══ This will translate your HTML script into the IPF format. IPF is used by the IBM IPFC compiler to generate INF and HLP files. IPFC compiler is not provide with HTLMGen. ═══ 5.1.8. Editor ═══ This will load the current text area to the defined file and call an editor you have defined. ═══ 5.1.9. Exit ═══ This will exit the program. Short-cut key is F3. ═══ 5.2. Options ═══ There are three options to provide HTMLGen with Browser/Editor and Text prompting indicators. ═══ 5.2.1. Browser Defined ═══ Will pop-up a dialog box asking for the command to load your Web browser. ═══ 5.2.2. Editor Defined ═══ Will pop-up a dialog box asking for the command to load your editor. ═══ 5.2.3. Text Prompting ═══ This will turn-on/off the dialog boxes when the Tagging functions are used. ═══ 5.2.4. IPF Conversion Options ═══ There are three options available for the IPFC Conversion. RES for Headings Turn this on and a resource number will be assigned to each heading. This is useful for creating HLP files. HLP files work with PM Help functions. Resources are associated with PM items such when F1 is pressed when the cursor is on a button, defining the HELP push button, etc... Index for Headings Turn this on and each heading will have a IPF index assigned to it. For the Heading 1, only an I1 tag is created. For all other headings an I1 tag is created and an I2 tag with a reference to the previous I1 tag. Indexes define what shows up in the INDEX for your both HLP and INF files. ═══ 5.2.5. Edit Macros ═══ This provides a dialog box to maintain your macros. Prompts are shown in the macro list and text is entered into the macro list when the prompt is double-clicked. Macros are maintained an editible file HTMLGEN.MAC. The format is rather simple. A keyword "PROMPT:" is used to indicate a new macro. Text on the same line as "PROMPT:" is used for the macro prompt. All text following the prompt is considered to be macro "text" that is inserted into the HTML document when the prompt is double-clicked. ═══ 5.3. Tags ═══ Tags are the indentifies for the browser on how to display and format text, pull in external files, and layout the general document. ═══ 5.3.1. Headings ═══ Title The Title Tag describes the title of the HTML Document Heading 1

The Heading 1 Tag marks the highest level sections in the document. Its text and font are the same size as the TITLES. Think of Heading 1 Tags as chapter indicators. Short-Cut Key is Ctrl-1. Heading 2

The Heading 2 Tag marks the second highest level sections within a Heading 1 section. Its text and font are smaller than a Heading 1. Short-Cut Key is Ctrl-2. Heading 3

The Heading 3 Tag marks the third highest level sections in a document and follows a Heading 2 section. Its text and font are smaller than a Heading 2. Short-Cut Key is Ctrl-2. Heading 4

The Heading 4 Tag marks the fourth highest level sections in a document and follows a Heading 3 section. Its text and font are smaller than a Heading 3. Short-Cut Key is Ctrl-3. Heading 5
The Heading 5 Tag marks the fifth highest sections and second lowest in a document and follows a Heading 4 section. Its text and font are smaller than a Heading 4. Short-Cut Key is Ctrl-5. Heading 6
The Heading 6 Tag marks the lowest sections in a document and follows a Heading 5 section. Its text and font are smaller than a Heading 5. Short-Cut Key is Ctrl-6. ═══ 5.3.2. Lists ═══ Unordered Lists Unrdered lists provide the ability to set off lists of text that are prefixed by bullets, dashes and filled circles. Unorder lists may be contained within other list types and may contain other list types. Short-cut key is Alt-u. Ordered Lists
Ordered lists provide the ability to set off lists of text that are prefixed by a sequence of numbers. Ordered lists may be contained within other list types and may contain other list types. Short-cut key is Alt-o. List Item (Order/Unordered List)
    • List Item Tag provides an item within an Unorder or Order list. List Items must appear within an or
    block. Short-cut key is CTRL-i. Descriptive Lists
    Provides a list that contains a title and a description items. Short-cut key is Alt-d. Descriptive Title and Description. Descriptive Titles and Descriptions are used to mark informative areas of text. Descriptive Title and Text appear in pairs with in a
    block. Short-cut key is Ctrl-d. Descriptive Title
    This provides for title for the following descriptive text. Descriptive Description
    This provides a description used with the Descriptive Title. It may contain paragraphs, other lists and other information. ═══ 5.3.3. Blocks ═══ Preformatted Text
    The preformatted tag marks text for fixed-width font with carriage returns, spaces and tabs kept in place. This section may contain other tags. Short-cut key is Alt-p. Quoted Text
    The block quote tag marks text for fixed-width font with carriage returns, spaces and tabs kept in place. This section may contain other tags. Short-cut key is Alt-q. Address
    The address tags is used to describe the author of the document. It is usually the last item in the document. This section may contain other tags. Short-cut key is Alt-a. Anchor Name The anchor name text provides to ability for other sections of the docuement to refer back to this section of text. Short-cut key is Alt-n. Anchor Reference The anchor name text provides to ability to refer back to another section of text mark by an anchor name. Short-cut key is Alt-r. ═══ 5.3.4. Formats ═══ Formats provide changing the fonts of text. o ITALICS - Italics - Short-cut key is Ctrl-i. - Emphasised Italics - Short-cut key is Ctrl-e. - Citation - Short-cut key is Ctrl-c. - Variable - Short-cut key is Ctrl-i. o BOLDS - Bold - Short-cut key is Ctrl-b. - Strong bold - Short-cut key is Ctrl-s. o MONO-SPACED - Typewriter - Short-cut key is Ctrl-t. - Code - Short-cut key is Ctrl-C. - Sample - Short-cut key is Ctrl-s.. - Keyboard - Short-cut key is Ctrl-k. o Definition - Short-cut key is Ctrl-d. May not work with some Mosiac browers. ═══ 5.3.5. Special Characters ═══ o 'Less Than' character '<' is <. o 'Greater Than' character '>' is >. o 'Ampersand' character '&' is &. o The paragraph marker indicates a new paragraph.

    - can be used to indicate an end of a paragraph block. Short-cut key is Ctrl+Enter. ═══ 5.3.6. Images ═══ Inline Images Provides inline GIF or x-systems XBM pictures to display within your the document. Short-cut key is ALT-SHIFT-I. External Images link anchor Refers to GIF or XBM files that reside elsewhere. It also provides for referencing. See Anchors. Short-cut key is ALT-SHIFT-E. ═══ 6. Dialog Boxes ═══ There are several dialog boxes to assist you in generating your HTML script. These boxes can be disabled by turning off the Text Prompting off of options. When Text Prompting is turned off, you are not prompted for text and the tag is immediately inserted into the script. The titles of the dialog boxes will change depending on the tag being generated and what type of work it is doing. ═══ 6.1. Desc Dialog Box ═══ This box is used to define both the Descriptive Item Heading and Descriptive Item Text. This will generate the
    and tags. If text is not entered into either fields the tagged items are added to the script only, respectfully. ═══ 6.2. Ext Dialog Box ═══ This box is used to define an external file anchor. The dialog will generate the zzzzz tag. Where xxxxx is the name of the external (referenced) file, yyyyy is the named anchor and zzzzz is the text that will be highlighted and provide linking. ═══ 6.3. Extern Dialog Box ═══ This box is used to define an external image file and refernce text. The dialog will generate the zzzzz tag. Where xxxxx is the name of the external(image file and zzzzz is the text that will be highlighted and provide linking. The FIND button starts the PM Find File dialog to help you search for a file. Supported image files are o GIF o TIFF o JPEG o RGB o HDF ═══ 6.4. Inline Image Dialog Box ═══ This box provices the IMG tagto alloc for XBM and GIF format images inside your HTML document. This tag is not recognized by all browsers. The FIND button starts the PM Find File dialog to help you search for a file. ═══ 6.5. Single Line Dialog Box ═══ This box is used for tags that use a single line of text, such as headers and the address tags. ═══ 6.6. Anchor Dialog Box ═══ The box will allow you to define an anchor title and text. It generates an tag. ═══ 6.7. Simple Text Dialog Box ═══ This box is used for tags that use multiple lines of text, such as tagging formatted text or defining block quotes. The dialogs main item is a multi-line edit field. This field supports most of OS/2 cut and paste functions. ═══ 7. History Of Changes ═══ HTMLGen 1.10 A HTML Script Generator History of changes. 1. Version 1.10 Aug. 15, 1995 o Added user-defined macro support. o Added a backslash to the end of the special characters & . 2. Version 1.05 Jan. 31, 1995 o Corrected problem with data entry fields being too short or not usable. o Improved help. o Allowed both HTML script and IPF script screens to be re-sizable. 3. Version 1.04 Jan. 25, 1995 o Corrected problem with files, i.e. your browser, being corrupted o Enlargened field lengths. o Corrected problem with some tags. 4. Version 1.03 Jan. 21, 1995 o Integrated Browser/Editor programs. o Added INI file. o Improved IPF converter. 5. Version 1.02 Jan. 14, 1995 o First general release. ═══ 8. Author's Address and Information. ═══ American Coders, LTD joe@usacoder.rtp.nc.us (919) 846-2014 Copyright 1995 - All rights reserverd